﻿
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- saved from url=(0014)about:internet -->
<html xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:mssdk="winsdk" xmlns:script="urn:script" xmlns:build="urn:build" xmlns:MSHelp="http://msdn.microsoft.com/mshelp">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="Description" content="The KDbgCtrl command line uses the following syntax:"/>
<meta name="MSHAttr" content="PreferredSiteName:MSDN"/>
<meta name="MSHAttr" content="PreferredLib:/library/windows/hardware"/>
<title>KDbgCtrl Command-Line Options</title>

<meta name="MS-HAID" content="r12_cmdline_a9393ea1-02b9-4fd2-9e74-ee7db7287a66.xml"/>


<link rel="STYLESHEET" type="text/css" HREF="../common/backsdk4.css"/>





<style>
html,div { margin: 0; padding: 0;}

body {
	padding: 0px;
	margin: 0px;
	overflow: auto;
	height: 100%;
}

#winchm_template_button{
	float: right;
	width: 93px;
	top: 7px;
	position: relative;
	text-align: right;
	right: 5px;
	height: auto;
}

#winchm_template_top{
	padding: 0px;
	margin: 0px;
	border-bottom: 1px solid #9B9B9B;
	background-color: #B1CEFE;
}

#winchm_template_navigation{
	margin: 0px;
	padding-top: 7px;
	padding-left: 7px;
	padding-bottom: 3px;
	padding-right: 0px;
	font-size: 8.5pt;
	font-family: Arial, Helvetica, sans-serif;
	font-weight: normal;
	color: #585858;
}

#winchm_template_title{
	margin: 0px;
	padding-top: 4px;
	padding-left: 7px;
	padding-bottom: 7px;
	padding-right: 0px;
	font-size: 18px; 
	font-family: Verdana, Geneva, sans-serif;
	color: #363636;
}

#winchm_template_content{
	margin-top: 20px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	width: auto  !important;
	width: 100%;
}

#winchm_template_footer{
	border-width: 1px;
	border-color: #B1CEFE;
	border-top-style: solid;
	margin-top: 15px;
	margin-left: 15px;
	margin-bottom: 20px;
	margin-right: 15px;
	padding-top: 7px;
	padding-left: 0px;
	padding-bottom: 0px;
	padding-right: 0px;
	font-family: arial, helvetica, sans-serif;
	font-size: 8.5pt;
	color: #696969;
	width: auto;
	text-align: left;
}


#winchm_template_container{
	margin: 0px;
	padding: 0px;
	position: static;
	padding-bottom: 3px;
	overflow: auto;
	background-color: #FFFFFF;
}


@media print
{
#winchm_template_container{
	position: static;	
	margin: 0px;
	padding: 5px;
	
	width: auto;
	height: auto;
	overflow: auto;
}
#winchm_template_button{
visibility:hidden;
}
}

#winchm_template_navigation A:link	{text-decoration: none; color:#004080}
#winchm_template_navigation A:visited  {text-decoration: none; color: #004080}
#winchm_template_navigation A:active {text-decoration: none; color: #004080 }
#winchm_template_navigation A:hover {text-decoration: none;color: #0080FF}

A:link	{text-decoration: underline; color:#0033CC}
A:visited  {text-decoration: underline; color: #0033CC}
A:active {text-decoration: underline; color: #0033CC }
A:hover {text-decoration: underline;color: #FF0000;}
</style>
<script type="text/javascript">
function isMobile(){
Agent = window.navigator.userAgent;
if (Agent.indexOf("iPhone")>=1 || Agent.indexOf("iPad")>=1 || Agent.indexOf("iPod")>=1 || Agent.indexOf("Android")>=1){
return true;
}else{
return false;	
}

}
function d_onresize(){
if (window.navigator.userAgent.indexOf("MSIE")>=1){
document.getElementById('winchm_template_container').style.pixelWidth = document.body.offsetWidth - 3;
document.getElementById('winchm_template_container').style.pixelHeight = document.body.offsetHeight - document.getElementById('winchm_template_top').offsetHeight - 4;
}
document.getElementById('winchm_template_container').style.top = document.getElementById('winchm_template_top').offsetHeight + 'px';
}

function d_onbeforeprint(){
document.getElementById('winchm_template_container').style.width = 'auto';
document.getElementById('winchm_template_container').style.height = 'auto';
}

function d_onafterprint(){
d_onresize();
}

if(!isMobile()){

window.onload = d_onresize;
window.onresize = d_onresize;
window.onbeforeprint = d_onbeforeprint;
window.onafterprint = d_onafterprint;

document.write("<style>\n");
document.write("body {overflow: hidden;}\n");
document.write("#winchm_template_container {position: absolute;overflow: auto;top : 0px;right: 0px;bottom: 0px;left: 0px;}\n");
document.write("</style>\n");
}

</script>
</head>
<body><script language="JavaScript" type="text/JavaScript">
function syn(){
if(parent.nav.tree){
 if(parent.nav.tree.loaded){
  parent.nav.tree.selectNode(1909);
 }else{
  setTimeout("syn()",500);
}
  }else{
  setTimeout("syn()",500);
  }}
if(parent!=self){
  setTimeout("syn()",100);
}else{
  parent.location.href = "../../index.htm?page=debugger/kdbgctrl_command_line_options.htm";
}
originalOnload = window.onload;
if(originalOnload==null){
window.onload = function(){parent.contentLoaded = true;};
}else{
window.onload = function(){originalOnload();parent.contentLoaded = true;};
}
</script> 


<div id="winchm_template_top">
	<div id="winchm_template_button"><A href="dbengprx_command_line_options.htm" title="Previous topic"><img id="winchm_template_prev" alt="Previous topic" src="../template2/btn_prev_n.gif" border="0"></a><A href="dbgrpc_command_line_options.htm" title="Next topic"><img id="winchm_template_next" alt="Next topic" src="../template2/btn_next_n.gif" border="0"></a></div>
	<div id="winchm_template_navigation">Help &gt; 
<A href="introduction6.htm">Debugging Tools for Windows (WinDbg, KD, CDB, NTSD)</A> &gt; <A href="debugger_reference.htm">Debugger Reference</A> &gt; <A href="command_line_options.htm">Command-Line Options</A> &gt; </div>
	<div id="winchm_template_title">KDbgCtrl Command-Line Options</div>
</div>
<div id="winchm_template_container">
	<div id="winchm_template_content"><div id="mainSection"><p>The KDbgCtrl command line uses the following syntax:</p>
<pre class="syntax">
    <b>kdbgctrl [-e|-d|-c] [-ea|-da|-ca] [-eu|-du|-cu] [-eb|-db|-cb] [-sdb </b><i>Size</i><b> | -cdb] 

kdbgctrl -cx 

kdbgctrl -td </b><i>ProcessID</i><i> File</i><b> 

kdbgctrl -? 
</b>
   </pre>
<h2><a id="ddk_kdbgctrl_command_line_options_dbg"></a><a id="DDK_KDBGCTRL_COMMAND_LINE_OPTIONS_DBG"></a>Parameters</h2>
<p></p>
<dl>
<dt><a id="_______-e______"></a><a id="_______-E______"></a>       <b>-e</b>      </dt>
<dd>
<p>Enables Full Kernel Debugging.</p>
</dd>
<dt><a id="_______-d______"></a><a id="_______-D______"></a>       <b>-d</b>      </dt>
<dd>
<p>Disables Full Kernel Debugging.</p>
</dd>
<dt><a id="_______-c______"></a><a id="_______-C______"></a>       <b>-c</b>      </dt>
<dd>
<p>Checks whether Full Kernel Debugging is enabled. Displays true if Full Kernel Deubugging is enabled, and displays false if Full Kernel Debugging is disabled.</p>
</dd>
<dt><a id="_______-ea______"></a><a id="_______-EA______"></a>       <b>-ea</b>      </dt>
<dd>
<p>Enables Automatic Kernel Debugging.</p>
</dd>
<dt><a id="_______-da______"></a><a id="_______-DA______"></a>       <b>-da</b>      </dt>
<dd>
<p>Disables Automatic Kernel Debugging.</p>
</dd>
<dt><a id="_______-ca______"></a><a id="_______-CA______"></a>       <b>-ca</b>      </dt>
<dd>
<p>Checks whether Automatic Kernel Debugging is enabled. Displays true if Automatic Kernel Deubugging is enabled, and displays false if Automatic Kernel Debugging is disabled.</p>
</dd>
<dt><a id="_______-eu______"></a><a id="_______-EU______"></a>       <b>-eu</b>      </dt>
<dd>
<p>Enables User-Mode Error Handling.</p>
</dd>
<dt><a id="_______-du______"></a><a id="_______-DU______"></a>       <b>-du</b>      </dt>
<dd>
<p>Disables User-Mode Error Handling.</p>
</dd>
<dt><a id="_______-cu______"></a><a id="_______-CU______"></a>       <b>-cu</b>      </dt>
<dd>
<p>Checks whether User-Mode Error Handling is enabled. Displays true if User-Mode Error Handling is enabled, and displays false if User-Mode Error Handling is disabled.</p>
</dd>
<dt><a id="-eb"></a><a id="-EB"></a><b>-eb</b></dt>
<dd>
<p>Enables blocking of kernel debugging.</p>
</dd>
<dt><a id="-db"></a><a id="-DB"></a><b>-db</b></dt>
<dd>
<p>Disables blocking of kernel debugging</p>
</dd>
<dt><a id="-cb"></a><a id="-CB"></a><b>-cb</b></dt>
<dd>
<p>Checks whether kernel debugging is blocked. Displays true if kernel debugging is blocked, and displays false if kernel debugging is not blocked.</p>
</dd>
<dt><a id="_______-sdb_______Size______"></a><a id="_______-sdb_______size______"></a><a id="_______-SDB_______SIZE______"></a>       <b>-sdb</b>       <i>Size</i>      </dt>
<dd>
<p>Sets the size of the DbgPrint buffer. If <i>Size</i> is prefixed with <b>0x</b> it will be interpreted as a hexadecimal number. If it is prefixed with <b>0</b> (zero), it will be interpreted as octal. Otherwise, it will be interpreted as decimal.</p>
</dd>
<dt><a id="_______-cdb______"></a><a id="_______-CDB______"></a>       <b>-cdb</b>      </dt>
<dd>
<p>Displays the current size, in bytes, of the DbgPrint buffer.</p>
</dd>
<dt><a id="_______-cx______"></a><a id="_______-CX______"></a>       <b>-cx</b>      </dt>
<dd>
<p>Determines the current Full Kernel Debugging setting and returns an appropriate value. This option cannot be combined with other options, and it does not display any output. It is designed for use in a batch file where the return value of the KDbgCtrl program can be tested. Possible return values are as follows:</p>
<table>
<tr>
<th>Value</th>
<th>Meaning</th>
</tr>
<tr>
<td>
<p><b>0x10001</b></p>
</td>
<td>
<p>Full Kernel Debugging is enabled.</p>
</td>
</tr>
<tr>
<td>
<p><b>0x10002</b></p>
</td>
<td>
<p>Full Kernel Debugging is disabled.</p>
</td>
</tr>
<tr>
<td>
<p>Any other value</p>
</td>
<td>
<p>An error occurred. KDbgCtrl was unable to determine the current status of Full Kernel Debugging.</p>
</td>
</tr>
</table>
<p> </p>
</dd>
<dt><a id="-td_ProcessID_File"></a><a id="-td_processid_file"></a><a id="-TD_PROCESSID_FILE"></a><b>-td </b><i>ProcessID</i><i> File</i></dt>
<dd>
<p>Obtains a kernel triage dump file. Enter the process ID and a name for the dump file.</p>
</dd>
<dt><a id="_______-_______"></a>       <b>-?</b>      </dt>
<dd>
<p>Displays command-line help for KDbgCtrl.</p>
</dd>
</dl>
<h3><a id="Additional_Information"></a><a id="additional_information"></a><a id="ADDITIONAL_INFORMATION"></a>Additional Information</h3>
<p>For a description of all the KDbgCtrl settings, see <a href="#Bookmark29">Using KDbgCtrl</a>.</p></div></div>	
	<div id="winchm_template_footer">Copyright &copy; 2019. All rights 
reserved. (To change the copyright info, just edit it in template.)</div>
</div>

</body>
</html>
